今天要繼續串接剩下功能:
API | 方法網址 | HTTP METHOD |
---|---|---|
愛心碼查詢 | /PB2CAPIVAN/loveCodeapp/qryLoveCode | POST |
載具發票表頭查詢 | /PB2CAPIVAN/invServ/InvServ | POST |
載具發票號碼明細查詢 | /PB2CAPIVAN/invServ/InvServ | POST |
載具發票捐贈 | /PB2CAPIVAN/CarInv/Donate | POST |
手機條碼歸戶載具查詢 | /PB2CAPIVAN/Carrier/Aggregate | POST |
已歸戶載具個別化主題 | https://sip.einvoice.nat.gov.tw/ods-main/ODS3 | GET |
查詢目前電子發票平台已經完成註冊登記愛心碼的社福團體。
POST https://api.einvoice.nat.gov.tw/PB2CAPIVAN/loveCodeapp/qryLoveCode
|參數名稱 |是否必填 |參數格式 |說明 |範例|
|:-|
|version| 是| 浮點數| 版本號碼(帶入範例值即可)| 0.2|
|qKey| 是 |字串 |要查詢的愛心碼/統編之關鍵字| 621|
|action |是 |字串 |API 行為(帶入範例值即可)| qryLoveCode|
|UUID |是| 字串 |行動工具 Unique ID| |
|appID| 是 |字串 |透過財政資訊中心大平台申請之軟體 ID| |
POST request data
$postData = array(
'version' => '0.2'
, 'action' => 'qryLoveCode'
, 'qKey' => '88432'
, 'appID' => 'EINV12017XXXXXXXX'
, 'UUID' => '123456'
);
'88432'
為 財團法人喜憨兒社會福利基金會 之愛心碼
查詢成功會得到 社福團體統一編號、愛心碼、社福名稱及社福簡稱等資訊
["details"]=>
array(1) {
[0]=>
array(5) {
["rowNum"]=>
int(0)
["SocialWelfareBAN"]=>
string(8) "92070381"
["LoveCode"]=>
string(5) "88432"
["SocialWelfareName"]=>
string(42) "財團法人喜憨兒社會福利基金會"
["SocialWelfareAbbrev"]=>
string(9) "喜憨兒"
}
}
//'qKey'同時也可以用來查詢社福機構名稱
//若有多筆查詢結果,會將資訊放入 array ["details"] 中
'qKey' => '醫院'
//response
["details"]=>
array(7) {
[0]=>
array(5) {
["rowNum"]=>
int(0)
["SocialWelfareBAN"]=>
string(8) "93506428"
["LoveCode"]=>
string(3) "299"
["SocialWelfareName"]=>
string(33) "財團法人台東基督教醫院"
["SocialWelfareAbbrev"]=>
string(6) "東基"
}
[1]=>
array(5) {
["rowNum"]=>
int(1)
["SocialWelfareBAN"]=>
string(8) "94607424"
["LoveCode"]=>
string(3) "555"
["SocialWelfareName"]=>
string(54) "臺灣基督教門諾會醫療財團法人門諾醫院"
["SocialWelfareAbbrev"]=>
string(12) "花蓮門諾"
}
...